.. _cmlStSetCount:

cmlStSetCount 
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlStSetCount ([in] VT_I4 BoardId, [in] VT_I4 Channel, 
    [in] VT_I4 Source, [in] VT_I4 pdwCount)            

DESCRIPTION
`````````````  

- 지정한 채널의 지정한 카운터의 값을 새로이 설정합니다. 단, 이때 지정하는 카운터값의 
  단위는 펄스수입니다.

\

- 이 함수는 카운터의 값을 지정하는 매개 변수(媒介變數)의 단위가 펄스수라는 것을 
  제외하고는 cmlStSetPosition() 함수와 동일합니다.    

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardId: 사용자가 설정한 디바이스(보드) ID. 
 
▶ Channel : 축(채널) 번호. 축번호는 상수값으로  3번째 채널을 기준 채널로 임의의 채널을 
설정할 수 있습니다.  
 
▶ Source: 설정할 카운터 번호. 이 값은 다음의 4가지 값중의 하나이어야 합니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    0 또는 cmlCNT_COMM, Command Counter  
    1 또는 cmlCNT_FEED, Feedback Counter 


▶ pdwCount: 지정한 값으로 대상 카운터의 값을 설정합니다. 이 값은 이 값은 논리단위가 
아닌 실제 펄스 카운트값입니다. 

RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+

SEEALSO
```````````````

.. seealso:: :ref:`cmlStGetCount`